home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 051-075 / scopedisk51 / mach25 / machii.doc < prev    next >
Text File  |  1995-03-18  |  38KB  |  938 lines

  1.       MachII     Mouse Accelerator with Hotkeys (and other stuff).
  2.              Version 2.5  01-11-88.
  3.       SetMach     MachII configuration program.
  4.              Version 2.5  01-11-88.
  5.  
  6.              Copyright 1988 by Brian Moats
  7.  
  8.       This program may be freely distributed but may not be used in any
  9.       commercial product without prior written permission.
  10.  
  11.       Source is available. Shareware donations ACCEPTED.
  12.  
  13.  
  14.  
  15.             >>>>>>>>>>>  NOTE TO 2.4 USERS:  <<<<<<<<<<<            >>>>>>>>>>>  NOTE TO 2.4 USERS:  <<<<<<<<<<<
  16.  
  17.       MachII  is  now two separate programs. SetMach is the configuring
  18.       program. SetMach will read  both 2.4    and 2.5  config files while
  19.       MachII will  read only 2.5 configs. Run MachII, cancel the "Can't
  20.       Find Configuration  File" requester,  run SetMach,  load your old
  21.       config file and save it.
  22.  
  23.       Throughout this  document a "*" will indicate a place where some-
  24.       thing new to 2.5 is discussed.
  25.  
  26.       Note: UDK indicates that the key is a user definable key.
  27.  
  28.  
  29.  
  30.       For those who hate  doc files,  just type  "run MachII"  and then
  31.       "Cancel" the  "Can't Open  Configuration File!". Now activate the
  32.       clock window with your mouse    and  press  the  right    button. The
  33.       requester displayed  has all    of your options and hotkeys. Change
  34.       them    to  what  you  like  and  save    it.   And  try     this;    hit
  35.       Alternate-Escape,   then   Amiga-F1,     then  type  (for  example)
  36.       "diskcopy df0: to df1:",  then  hit  Alternate-Escape  again. Now
  37.       press  Amiga-F1.  Also  look    at  F1 in the requester. Read on if
  38.       you're still interested.
  39.  
  40.       FEATURES
  41.  
  42.       Hotkeys          30 macros activated with the Function keys or
  43.                   the  Amiga  or  Ctl-Amiga-Function keys or by
  44.                   typing the first few  letters  of  the macro.
  45.                   Macros may  be automatically recorded and may
  46.                   include mouse buttons.
  47.      *      Configurations      Multiple    configurations    may  be   used    and
  48.                   attached to windows by their title.
  49.       Auto Execute          Automatically execute macros at startup or at
  50.                   a specific preset time.
  51.       Help Screen          Display a chart with  the current  macro def-
  52.                   initions.
  53.       Accelerator          Speeds up mouse movements. Adjustable.
  54.       PopCli          Execute a NewCLI or any other command.
  55.       Screen Blanker      Blank or    dim the  screen after an adjustable
  56.                   period of time.
  57.       Mouse Off          Turn off the mouse  after a  specified number
  58.                   of seconds of no mouse activity.
  59.       SunMouse          Activate    a  window  by moving the mouse into
  60.                   it.
  61.       ClickToFront          Move a  window  to  the  front  by  single or
  62.                   double clicking in any part of it.
  63.       Cycle           Move a  window (or  screen) to  the back with
  64.                   the left then right mouse button combination.
  65.      *      Window Shuffler     Send the front window  to  the  back  and the
  66.                   back  window  to    the front with Left-Amiga-K
  67.                   and Left-Amiga-J. (User definable keys)
  68.       Screen Shuffler     Use Left_Amiga-M to push    any  screen  to the
  69.                   back.
  70.       Clock           Optional title bar clock with memory display,
  71.                   date and low memory warning.
  72.       Alarm           Set one alarm.
  73.       Beeper          Beep every 15 minutes. Adjustable.
  74.       Meter           Maintain online costs. Adjustable rates.
  75.       Qualifier Accum     Accumulate qualifiers to be added to a key or
  76.                   to   mouse   activity   such  as    Workbench's
  77.                   extended selection.
  78.     *      Reset Preferences   Reset your preferences to what they were when
  79.                   MachII  was  first  started using Ctl-LShift-
  80.                   LAlt-LAmiga-ESCape.
  81.     *      Set Preferences     Set preferences  from a macro using  \pconfig
  82.  
  83.  
  84.       All features may be turned off. Unused hotkeys are passed through
  85.       and may be defined on the fly. The configuration file is saved to
  86.       disk.  See the SPECIAL KEYS  section    near  the  end    for  a des-
  87.       cription of all user definable keys.
  88.  
  89.  
  90.       UPDATES:
  91.  
  92.       2.5     a. MachII has been split  into  two  separate    programs. A
  93.             configuring program SetMach, and MachII itself. SetMach
  94.             may be invoked either by running  it like  any program,
  95.             by activating  the clock  and clicking the right button
  96.             or with the  combination  Control-Left-Amiga-ESC (UDK).
  97.             It will detach so you don't need to "Run" it.
  98.          b. Multiple configurations  are supported  and each may be
  99.             attached to a window by  its  title.  Select  a config-
  100.             uration  by  clicking  in  a  window that has a config-
  101.             uration with the same  title.  Cycle  through  the con-
  102.             figurations  with  Control-Left-Amiga-C  (UDK), or with
  103.             the up and down gadgets in SetMach.
  104.          c. Mouse Off works better with some  programs (like UEdit)
  105.             and turns  the mouse  off when any non-qualifier key is
  106.             pressed.
  107.          d. Has a 12 or 24 hour  clock. (Some  people still  like a
  108.             clock)
  109.          e. Running MachII  a second  time will  remove it. Running
  110.             SetMach a second time simply pops the first  one to the
  111.             top.
  112.          f. Select a configuration from a macro with \ctitle.
  113.          g. Send the front window to the back. Left-Amiga-K (UDK).
  114.          h. Send the back window to the front. Left-Amiga-J (UDK).
  115.          i. Pop the clock to the top screen. Left-Amiga-C (UDK).
  116.          j. Pop up the help screen. Alternate-HELP (UDK).
  117.          k. Disable/enable hotkeys. Left-Amiga-H (UDK).
  118.          l. A  red  dot  appears  on  the  clock's  right edge when
  119.             hotkeys are disabled.
  120.          m. LeftMouse-RightMouse Cycle    combination  will  send the
  121.             screen to  the back if the pointer is not over a window
  122.             or is over a backdrop window.
  123.          n. The special key qualifiers    Left  and  Right  Amiga are
  124.             separate.
  125.          o. A  red  dot  appears  on  the  clock's  left  edge when
  126.             qualifiers are accumulating and qualifiers may be  held
  127.             if Alternate-CapsLock is first pressed.
  128.          p. A hotkey may call itself without crashing.
  129.          q. Use Ctl-LShift-LAlt-LAmiga-ESC to reset  preferences to
  130.             what they were when MachII was first run.
  131.          r. Set preferences using \pconfiguration. Configuration is
  132.             a file saved by Preferences.
  133.          s. Toggle the clock from a macro with \z.
  134.  
  135.  
  136.       OVERVIEW:
  137.  
  138.       Note: UDK indicates that the key is a user definable key.
  139.  
  140.       MachII is a utility program that provides many  optional features
  141.       for both  CLI and  WorkBench users (although it cannot be started
  142.       from an icon). Your own configuration may be saved to  disk. Each
  143.       function key    may be    used as  a hotkey  and their  macros may be
  144.       recorded on the fly. They may also include mouse button clicks.
  145.  
  146.       Other features include a  SunMouse  that  automatically activates
  147.       the window  that the    pointer is  over, ClickToFront which allows
  148.       you to bring a window to the front  by single  or double clicking
  149.       in any  part of  it and  many clock  features. It  is very easily
  150.       configurable to your own  desires. If  you don't  like a feature,
  151.       just    turn  it  off.    Run  the  configuration  program  by either
  152.       activating the clock and pressing the  right button  or by typing
  153.       Control-Left-Amiga-Escape  (UDK).  A  configuration  file  is not
  154.       necessary but  without one  you will    get the  defaults. You will
  155.       also get a "Can't Find Configuration File" requester.
  156.  
  157.       After you  have setup your macros and other options, you can save
  158.       this to the file s:mach.config.
  159.      *      New to  2.5 are  multiple configurations.  A linked  list is kept
  160.       which  you  can  add    or  delete  too.  Each configuration may be
  161.       attached to a window and activated by clicking in that window.
  162.  
  163.       As an  example  of the  flexibility and power of MachII,  (and to
  164.       show why there is so    many seemingly    useless escaped characters)
  165.       this macro  will  toggle  the Workbench  screen to  interlace and
  166.       change your preferences:
  167.  
  168.       Endcli\N\z\Xc:wbLace\\pdevs:sys-con.lace\\z\XNewShell "Newcon:0/0
  169.       /640/400/AShell"
  170.  
  171.       It ends the current shell, toggles the clock off, executes the
  172.       program wbLace, changes preferences, toggles the clock back on,
  173.       and finally creates a new shell.
  174.  
  175.  
  176.       USAGE:
  177.  
  178.      *      First, place SetMach and MachII in your current or c: directory.
  179.       Then type:
  180.  
  181.          Run MachII
  182.  
  183.       After it is running, you may either activate the clock with the
  184.       mouse and press the right button  or press Control-Left-Amiga-ESC
  185.       (UDK) or  type SetMach.  You do  not need to use "Run". This will
  186.       run SetMach  which has  a requester  jammed full  of gadgets. All
  187.       options and hotkeys may be modified here.
  188.  
  189.       NOTE: Do not rename SetMach or MachII won't be able to find it.
  190.  
  191.       The gadgets are:
  192.  
  193.       1st ROW
  194.            1st:  Toggle between Amiga, Control-Amiga and None hotkeys.
  195.      *           2nd:  Move up or down through the configurations.
  196.      *           3rd:  Title of window to attach this config too.
  197.      *           4th:  Add a new configuration to the list.
  198.      *           5th:  Delete a configuration.
  199.            6th:  Change the maximum macro size.
  200.  
  201.       2nd ROW
  202.            1st:  Select each hotkey with the 'Fn' gadgets.
  203.  
  204.       3rd ROW
  205.            1st:  Selected hotkey macro definition.
  206.      *           2nd:  Clear 1 macro with 1 click or up to 10 with 2 clicks.
  207.  
  208.       4th ROW
  209.            1st:  Amiga-ESC execute string.
  210.  
  211.       5th ROW
  212.            1st:  Activate/deactivate SunMouse.
  213.            2nd:  Select 0, 1 or 2 clicks for Click To Front.
  214.            3rd:  Select Cycle on or off.
  215.            4th:  Activate/deactivate the Amiga-M Screen Shuffler.
  216.  
  217.       6th ROW
  218.            1st:  Activate/deactivate the Qualifier Accumulator.
  219.            2nd:  Toggle the Clock.
  220.            3rd:  Toggle Online Meter.
  221.            4th:  Reset Online Meter.
  222.  
  223.       7th ROW
  224.            1st:  Select Clock Front or Clock Depth gadget.
  225.            2nd:  Select WBScreen, Screen Depth, or Clock To Top.
  226.            3rd:  Select Clock Only, Mem Only or Clock+Mem.
  227.  
  228.       8th ROW
  229.            1st:  Set the Clock's left edge.
  230.            2nd:  Set the Clock's top edge.
  231.      *           3rd:  Toggle between 12 and 24 hour clock time.
  232.            4th:  Set the  seconds to  alternate time  and date. 0=time
  233.              only.
  234.            5th:  Select online rate. ($00.00 - $99.99)
  235.  
  236.       9th ROW
  237.            1st:  Select blanking delay (0-99 minutes).
  238.            2nd:  Dimness level. 0 = Black, 15 = no change.
  239.            3rd:  Mouse off delay (0-99 seconds).
  240.            4th:  Select beep interval (0-999 minutes).
  241.            5th:  Set the alarm time. 24 hour format.
  242.            6th:  Change the acceleration rate (0-9).
  243.  
  244.       10th ROW
  245.            1st:  Step through the special functions.
  246.            2nd:  Select a key for the special function.
  247.            3rd:  Set the memory level to receive low memory warning.
  248.  
  249.       11th ROW
  250.            1st:  Select the Alternate qualifier for a special function.
  251.            2nd:  Select the Control qualifier for a special function.
  252.            3rd:  Select the Shift qualifier for a special function.
  253.      *           4th:  Select the Left-Amiga  (C=)  qualifier  for  a special
  254.              function.
  255.            5th:  Select the Right-Amiga qualifier for a special
  256.              function.
  257.  
  258.       12th ROW
  259.            1st:  Configuration file name.
  260.  
  261.       13th ROW
  262.            1st:  Done.
  263.            2nd:  Load configuration file.
  264.            3rd:  Save configuration file.
  265.            4th:  Remove MachII.
  266.  
  267.  
  268.       HOTKEYS:
  269.  
  270.       There are  30 hotkeys;  10 Function  keys, 10 Amiga-Function keys
  271.       and 10  Ctl-Amiga-Function keys.  "Hotkey" referred  to here will
  272.       mean any  one of these. Macro will mean the definition given to a
  273.       hotkey. In the requester  you can  select each  Function key with
  274.       the 'Fn'  gadgets and select the Ctl-Amiga/Amiga/None gadget. The
  275.       macros may be edited    in the    string gadget.    The default maximum
  276.       macro size  is 255 characters but this may be changed in the size
  277.       gadget. You cannot change the size while you    are creating  a new
  278.       macro  and  the  new    macro  size  will not take effect until you
  279.       select "Done". This controls  the size  of dynamic  buffers which
  280.       are allocated  only during macro definition or when the requester
  281.       is up. The actual macros take up only as much space as they need.
  282.  
  283.       Macros are  invoked either  by hitting  the hotkey  or by hitting
  284.       Shift-Alternate-Escape (UDK), then type some of the first letters
  285.       of the macro and then return. The first macro found  that matches
  286.       will be  executed. If none is found there will be a beep. See the
  287.       Special Keys section for changing the keys used.
  288.  
  289.      *      New to 2.5 is  the "c/ce"  gadget. Clicking  once will  clear the
  290.       selected  macro.  Clicking  twice  will clear all macros from the
  291.       selected one up to F10 for the active qualifier.
  292.       When a macro is executed that is longer than 20 characters or has
  293.       a pause in it, "Executing Macro..." is displayed in the clock.
  294.  
  295.  
  296.       Defining Macros:
  297.  
  298.       To define a macro, type Alternate-ESCape (UDK), then a hotkey and
  299.       the type  your macro. During these steps, you will be prompted by
  300.       messages in  the clock  and by  beeps. You  may use  any keys in-
  301.       cluding  qualifiers,    arrow  keys,  numeric keypad keys and mouse
  302.       buttons. When finished, hit Alternate-ESCape (UDK) again. You may
  303.       now use  your macro  by hitting the selected hotkey or by hitting
  304.       Shift-Alternate ESCape (UDK), enough characters to uniquely match
  305.       the macro  followed by  return. You  may also edit the macro in a
  306.       string gadget  by hitting  Control-Amiga-ESCape (UDK)  or by act-
  307.       ivating the  clock window  and pressing the right mouse button or
  308.       by running SetMach. All of these special keys  can be  changed to
  309.       your own  preferences. You  may also enter your macro directly in
  310.       the string gadget.
  311.  
  312.       Sample recording and playback session: Special keys are in <>.
  313.  
  314.            <Alt-ESC><Amiga-F1>Diskcopy df0: to df1:<Alt-ESC>
  315.  
  316.            'Diskcopy  df0:  to  df1:'  is  now  bound  to  the Amiga-F1
  317.            combination.
  318.  
  319.       To play this back, you can type either:
  320.  
  321.            <Amiga-F1>
  322.             Or
  323.            <Shift-Alt-ESC>dis<Return>
  324.  
  325.       The second  method searches  until it  finds a  macro whose first
  326.       letters match 'dis' and then plays the rest back. This  is useful
  327.       if you  don't remember  the function  key but do remember what it
  328.       begins with. If you also had a macro    that began  with 'disp' and
  329.       it was  before 'diskc...', and you typed only 'dis' the first one
  330.       matching 'dis' would be played back. In this case you  would need
  331.       to type 'disk'.
  332.  
  333.       You may  start a  learning period, do a series of complex editing
  334.       commands and then replay all of it. Or edit it and save for later
  335.       use. This  is especially  useful when  using word processors that
  336.       don't have macro abilities built in.
  337.  
  338.       Help Screen:
  339.  
  340.       A help screen with the macro definitions partially displayed in a
  341.       chart can  be popped    up by  using \h  in a macro. Executing that
  342.       macro   again will close the screen.    \hnnn may  be used  to also
  343.       specify the     height  of the screen.  You  could use a height of
  344.       200, push the clock    to that screen and  open the  requester and
  345.       have both  available at all  times. 52 is the minimum height. The
  346.       screen opens an interlaced screen if    the front  screen is inter-
  347.       laced.
  348.  
  349.      *      In version 2.5, you may use Alternate-HELP (UDK).
  350.  
  351.       Recording mouse clicks:
  352.  
  353.       Mouse clicks    may be    recorded or  entered in  the string gadget.
  354.       When a click is  detected, MachII  puts in  the mouse's position,
  355.       which button and whether it is pressed or released. For example:
  356.  
  357.       "\Mx155\My075\Mld" when played back, the mouse will be moved to x
  358.       = 155, y = 75 and a left button down will be sent. A \Pnn will be
  359.       inserted for    every second  delay between clicks. This will allow
  360.       for menus to drop or requesters  and    windows  to  open.  You may
  361.       delete them  from your  macro if not needed. Do not depend on the
  362.       SunMouse to activate a window  on  playback.    The  mouse  will be
  363.       moved to the same position as when recorded which may not be over
  364.       the desired gadget or icon. A qualifier such    as Shift  (\S) will
  365.       be placed before the first \M and will have effect over the mouse
  366.       positioning and the first click. e.g. \S\Mx330\My122\Mld.
  367.  
  368.  
  369.       Escaped keys:
  370.  
  371.       The escape character "\" may be used for the following:
  372.  
  373.             \N    Newline (return).
  374.             \T    TAB.
  375.             \E    ESCape.
  376.             \D    DELete.
  377.             \B    BACKSPACE.
  378.             \\    Backslash.
  379.             \H    HELP.
  380.             \u    Up arrow.
  381.             \d    Down arrow.
  382.             \l    Left arrow.
  383.             \r    Right arrow.
  384.             \0    Numeric pad 0.
  385.              .
  386.              .
  387.             \9    Numeric pad 9.
  388.             \.    Numeric pad ".".
  389.             \-    Numeric pad "-".
  390.             \e    Numeric pad ENTER.
  391.             \(  Numeric pad "(".  (Amigas 500 and 2000 only)
  392.             \)    Numeric pad ")".  (Amigas 500 and 2000 only)
  393.             \*    Numeric pad "*".  (Amigas 500 and 2000 only)
  394.             \+    Numeric pad "+".  (Amigas 500 and 2000 only)
  395.             \/    Numeric pad "/".  (Amigas 500 and 2000 only)
  396.             \F1 Function key 1.
  397.              .
  398.              .
  399.             \F0  Function key 10.
  400.  
  401.             \Y     Write the current date in the long form.
  402.             \y     Write the current date in the short form.
  403.             \b     Instant screen blanking.
  404.             \f     Load config file using name following f.
  405.      *            \c     Change to the configuration whose title follows c.
  406.      *            \p     Set preferences to the config file following p.
  407.      *            \z     Toggle the clock on or off.
  408.             \X     Execute the string following X.
  409.             \Pnn Pause nn seconds.
  410.             \Q     Quit. Remove MachII.
  411.             \G     Beep.
  412.             \a     Automatically    execute  the  macro  following "\a"
  413.              upon startup.    More than one macro may have the \a
  414.              and all will be executed.  First executed  are the
  415.              Amiga    Function  keys    1-10,  then  the  Ctl-Amiga
  416.              Function keys 1-10, then  the    Function  keys 1-10
  417.              with no  qualifiers. The  \a may  be followed by a
  418.              time in 24 hour format. The macro will be executed
  419.              at that time. e.g. "\a1045\G" At 10:45, beep.
  420.             \h     Display  or  close  a    help screen with macro def-
  421.              initions. Use    \hnnn to specify the screen height.
  422.              Minimum height = 52.  More commonly used in 2.5 is
  423.              the Alternate-HELP (UDK) key.
  424.  
  425.       These last twelve are unique in that they cannot be recorded live
  426.       but must be entered in the string gadget. (The \P is however also
  427.       recorded during mouse clicks).
  428.  
  429.      *      If \ffilename and \ctitle  are terminated  with a  "\", execution
  430.       will continue  after the  new configuration is made active at the
  431.       first character position of the same hotkey. Otherwise, execution
  432.       will stop after the configuration is loaded or changed.
  433.  
  434.       \Xstring and \pconfiguration    must  be terminated  with  a "\" if
  435.       not at the end of the macro.
  436.       e.g. "\XNewCLI\Dir\N" or "\XComm\\F1\F2".
  437.       Note    the two \s after "Comm". One terminates the "\XComm" string
  438.       and one introduces a function key.
  439.  
  440.             \M          Mouse info follows this.
  441.  
  442.             \Mxnnn    Send Mouse x coordinates.
  443.             \Mynnn    Send Mouse y coordinates.
  444.             \Mld      Send left button down.
  445.             \Mlu      Send left button up.
  446.             \Mrd      Send right button down.
  447.             \Mru      Send right button up.
  448.  
  449.  
  450.       Qualifiers modify the  character  or    mouse  activity immediately
  451.       following these:
  452.  
  453.             \C    Control.
  454.             \S    Shift (either one).
  455.             \A    Alternate (either one).
  456.             \L    Left-Amiga.
  457.             \R    Right-Amiga.
  458.  
  459.            An example:
  460.  
  461.             \Cc\u\A\S\l
  462.  
  463.            This plays back the key combinations:
  464.  
  465.             'Control-c' 'up-arrow' and 'alternate-shift-left-arrow'
  466.  
  467.       Auto Execution:
  468.  
  469.            \annnn  is  the    auto  execution  command. If nnnn = 0 or is
  470.            omitted,  the  macro  will  be  automatically  executed when
  471.            MachII is started
  472.  
  473.            An example:
  474.  
  475.            "\a\XNewCli  <Nil:   >Nil:"  will  open  a  new  CLI  window
  476.            automatically.
  477.  
  478.            If nnnn equals a  time of  0001 to  2359, the  macro will be
  479.            executed at that time.
  480.  
  481.            Another example:
  482.  
  483.            "\a930\XNewcli CON:220/50/200/50/Alarm\Call Joe\G\P3\CX
  484.            EndCLI>nil:\N"
  485.  
  486.            At 9:30 this will open a newcli in the center of the screen,
  487.            print  the  text  "Call  Joe", beep, pause 3 seconds, delete
  488.            (control-x) the  text and end the CLI  window. Note  the "\"
  489.            terminating the newcli string.
  490.  
  491.       The first hotkeys executed are the Amiga Function keys 1-10, then
  492.       the Ctl-Amiga Function keys 1-10,  then  the    Function  keys 1-10
  493.       with no  qualifiers. \a macros may also be executed manually. The
  494.       clock need not be displayed for this feature to work.
  495.  
  496.       Preference setting:
  497.  
  498.       You can change your preference settings by using  \pconfiguration
  499.       in a macro. The "configuration" is a file saved by Preferences.
  500.  
  501.         For example:
  502.           "\pdf0:devs/RedConfig"  will read in a file in df0:devs named
  503.           RedConfig and set your preferences to that.
  504.  
  505.       You can recall your original preferences with
  506.         Ctl-LShift-LAlt-LAmiga-ESC
  507.  
  508.       Multiple configurations:
  509.  
  510.      *      You may have as many configurations as you like. Each  one may be
  511.       attached to  a window through its title and activated by clicking
  512.       in its  window.  The    first  null  titled  configuration  will be
  513.       activated  when  no  title  matches.    The title need be just long
  514.       enough to uniquely match  a window's  title. The  "@" as  the 1st
  515.       character  will  lock  a  configuration  which  may  then only be
  516.       changed with SetMach or  by executing  a macro  that has  a title
  517.       following \c or with Control-Left-Amiga-C (UDK).
  518.  
  519.       Add  a  new  configuration  by  clicking on the "Add" gadget. The
  520.       previous  configuration  will  be  copied  into  the    new  one as
  521.       normally  you  will  want  to  make  only  minor changes. Anyway,
  522.       undoing a macro is easier than typing it in.
  523.  
  524.       Delete a configuration with the "Del" gadget.
  525.  
  526.       When a new configuration is made active, its title will appear in
  527.       the clock for about one second.
  528.  
  529.       If the  clock is  identical to the clock in the previously active
  530.       configuration, it will not be closed and reopened.
  531.  
  532.       Miscellaneous:
  533.  
  534.      *      Left-Amiga-H (UDK) toggles the  hotkeys on  and off.  A small red
  535.       dot will  appear on  the clock's  right edge when the hotkeys are
  536.       disabled.
  537.  
  538.       Function keys not assigned to a hotkey string are passed through.
  539.       Escaped letters are case sensitive.
  540.  
  541.       Note    above  that  function  key  numbers are single digits. This
  542.       means that 0 is F10, 1 is F1, 9 is F9.
  543.  
  544.       Macros may not be used for input during a \Pause.
  545.  
  546.       A macro may be aborted during execution with the ESCape key.
  547.  
  548.       Use \A for any Alternate key    sequences rather  than entering the
  549.       actual Alternate-key in the string gadget.
  550.  
  551.       If a    hotkey is embedded in a macro and the macro for that hotkey
  552.       is null, the    key  is  passed  through.  Otherwise  the  macro is
  553.       executed.
  554.  
  555.  
  556.       ACCELERATOR:
  557.  
  558.       The accelerator speeds up mouse movements. Set this from 0 - 9.
  559.       0 = no acceleration.
  560.  
  561.       NEWCLI:
  562.  
  563.       The Amiga  and ESCape  combination will create a NewCLI. You need
  564.       to have NewCLI and Run in the c: directory. The  NewCLI will have
  565.       the same size stack as MachII. You can change this command in the
  566.       execute string gadget. A full window example is:
  567.       "NewCLI CON:0/0/640/200/MyCLI".
  568.       You can also use the \X feature in a macro to execute a string.
  569.       For AmigaDos 1.3 you can,  of  course,  use  NewShell  instead of
  570.       NewCLI.
  571.  
  572.       SCREEN BLANKER:
  573.  
  574.       After 5 minutes of no mouse or keyboard activity, the screen will
  575.       dim. You can change the delay and dimness defaults in the "Delay"
  576.       and  "Dim"  gadgets.  Valid  dim  values are 0-15 with 0 equaling
  577.       black and 15 no dimming. The    numbers  0-6  are  the    only really
  578.       useful values.  0 blanks  the screen    by opening  a new screen in
  579.       front. The other values dim only the front screen. You can use \b
  580.       in a macro for instant blanking. 0 delay disables blanking.
  581.  
  582.       MOUSE OFF:
  583.  
  584.       After 10  seconds of    no mouse  activity, the  mouse pointer will
  585.       disappear. This is adjustable  with the  "Mouse" gadget. CAUTION:
  586.       be sure that your pointer is visible when running Preferences. It
  587.       is best to turn off the Mouse Off feature by setting its value to
  588.       0  before  running  Preferences.  Mouse  Off may affect the Pref-
  589.       erences settings changed by other programs. When the    mouse comes
  590.       back on,  ALL Preferences settings are set to what they were when
  591.       the mouse went off.
  592.      *      You can use the rather awkward combination of
  593.            Ctl-LShift-LAlternate-LAmiga-ESCape
  594.       to reset your preferences and restore your pointer.
  595.  
  596.       SUN MOUSE:
  597.  
  598.       The window  that the    pointer is  over becomes  the active window
  599.       after the  first mouse  movement. To    be able  to drag icons, the
  600.       SunMouse is disabled while the left button is held down.  The top
  601.       window will also become active when Amiga-N or Amiga-M is used.
  602.       Turn on or off with the "SunMouse" gadget.
  603.  
  604.       CLICK TO FRONT:
  605.  
  606.       You can  single or double click in any part of a window and bring
  607.       it to the front.
  608.       Select 0, 1, or 2 clicks with the "Click" gadget.
  609.  
  610.       CYCLE:
  611.  
  612.       You can push the window that is under  the mouse  to the  back by
  613.       holding the  left button  down and clicking the right button (the
  614.       opposite of extended menu selection). If  there are  fewer than 2
  615.       windows, the screen will be pushed to the back.
  616.       Turn on or off with the "Cycle" gadget.
  617.  
  618.      *      WINDOW SHUFFLER:
  619.  
  620.       You can  use Left-Amiga-J  (UDK) to  bring the back window to the
  621.       front and Left-Amiga-K (UDK) to  send  the  front  window  to the
  622.       back. The new top window will become the active window.
  623.  
  624.       SCREEN SHUFFLER:
  625.  
  626.       Left_Amiga-M will  push the  front screen  to the back instead of
  627.       pushing workbench to the back. Left_Amiga-N will still  bring the
  628.       workbench to    the front. This is useful if you have more than two
  629.       screens on at once,  especially if  they don't  have screen depth
  630.       gadgets.  The  window  under    the  mouse  will  become the active
  631.       window.
  632.       Turn on or off with the "Amiga-M" gadget.
  633.  
  634.       QUALIFIER ACCUMULATOR:
  635.  
  636.       Many disabled people find it difficult if not  impossible to type
  637.       key combinations such as Control-Shift-F1. MachII has the ability
  638.       to remember qualifiers that are pressed and add them to the first
  639.       non-qualifier key  pressed. So you could for example, type Shift,
  640.       Alternate, and then F1. The Shift and Alternate would be added to
  641.       the F1 just as if they were pressed at the same time. This is not
  642.       intended for someone who doesn't  need  it  as  it  sometimes may
  643.       cause unexpected  results. For example, if you type Alternate and
  644.       then change your mind, the Alternate will still  be added  to the
  645.       next key  pressed. Pressing  Caps Lock  or the right mouse button
  646.       will reset the qualifier accumulator. This may also  be used with
  647.       Workbench's extended  selection. Hit the Shift key, then click on
  648.       your icons. Hit any non-qualifier key  or the  right mouse button
  649.       to clear the Shift.
  650.  
  651.      *      Pressing a  qualifier twice will clear that qualifier. A tiny red
  652.       dot  will  appear  on  the  clock's  left  edge  when  there  are
  653.       qualifiers  accumulating.  All  qualifiers  will  stay  on  until
  654.       pressed a second time if you first press Alternate-CapsLock.
  655.       Turn on or off with the "Qual Accum" gadget.
  656.  
  657.  
  658.       CLOCK:
  659.  
  660.       There is a title bar clock that displays available memory and the
  661.       time. The  clock is updated every second and brings itself to the
  662.       front (if covered up) every 4 seconds except when the left button
  663.       is held  down. Sometimes  this covers up information in the title
  664.       bar so if you don't like this use the "Clock Front"/"Clock Depth"
  665.       gadget.  This  disables  the    auto  upfront  and adds an (almost)
  666.       invisible depth gadget. The date can alternate with  the time and
  667.       memory display.  The length of time that the time is displayed is
  668.       adjustable with the "Date Delay" gadget. Select 0  to display the
  669.       time only.  The date    is also  displayed when the clock window is
  670.       active.
  671.  
  672.       Clock and Memory Only:
  673.  
  674.       You can select "Clock Only" and get the clock and  date displayed
  675.       together in  the format  "mm-dd-yy hh:mm:ss" or select "Mem Only"
  676.       and get the memory display without the clock.
  677.  
  678.       Low Memory Warning:
  679.  
  680.       The time and memory are displayed  in red  (pen 3)  if your total
  681.       free memory  falls below  50k. You  can change  this value in the
  682.       "Low Mem" gadget.
  683.  
  684.       Twenty-four hour clock:
  685.  
  686.      *      You can  toggle between  a 12  and 24  hour clock  with the "Hrs"
  687.       gadget.
  688.  
  689.      *      You can put \z in a macro to toggle the clock on or off.
  690.  
  691.       Positioning the clock:
  692.  
  693.       You can  change the  clock's left  and top  edge in the requester
  694.       gadgets "ClockLE" and "ClockTE". These are the current  left edge
  695.       and top edge for the clock.
  696.  
  697.       You can position the clock then run SetMach and save the new pos-
  698.       ition.
  699.  
  700.       The width for the clock alone is 146 pixels. Memory  only display
  701.       is 170 pixels. The clock with memory display is 250 pixels wide.
  702.  
  703.       The Clock and other screens:
  704.  
  705.       There is  a gadget  above the  "ClockTE" gadget that will let you
  706.       make three choices.
  707.  
  708.            1.   WBScreen -    The  clock  will  remain  on  the workbench
  709.             screen.
  710.            2.   Screen Depth  - This  adds an invisible depth gadget to
  711.             the left edge of the clock. With it  you can  place the
  712.             clock on other screens.
  713.            3.   Clock To  Top - The clock will automatically pop to the
  714.             top screen.
  715.  
  716.       Options 2 and 3 replace the CloseScreen vector to allow MachII to
  717.       close its windows. Selecting option 1 or removing MachII will put
  718.       back the original vector.  If another  program also  replaced the
  719.       vector,  you    will  be  given  the  opportunity to terminate that
  720.       program before the original vector  is  replaced.  If  you  get a
  721.       requester with  the message  "CloseScreen Vectors Were Changed!",
  722.       either terminate the program that changed  the vectors  and click
  723.       Retry or just click Cancel. You cannot change these options while
  724.       on another screen. If WBScreen is  selected, the  vectors are NOT
  725.       changed.
  726.  
  727.      *      You  can  use  Left-Amiga-C  (UDK)  to  pop  the clock to the top
  728.       screen. Screen Depth mode will be automatically be selected.
  729.       Turn the clock on or off with the "Clock" gadget.
  730.  
  731.       ALARM:
  732.  
  733.       You may set 1 alarm time in 24 hour format. When it  goes off, it
  734.       will beep  longer than  the interval    beeper and  the screen will
  735.       flash. Set to greater than 2400 for no alarm. Note  that with the
  736.       auto execute    feature (\annnn)  you may create all sorts of fancy
  737.       alarms.
  738.  
  739.       BEEPER:
  740.  
  741.       There is  a beeper  (to keep  you awake)  which defaults  to a 15
  742.       minute interval.  Change this  in the  Beeping gadget.  \G may be
  743.       used in a macro to beep; prompt for user input for example.
  744.  
  745.       METER:
  746.  
  747.       MachII has an online cost meter. Use the "Meter" gadget to toggle
  748.       between the  meter and the clock. Use the "Reset" gadget to reset
  749.       the meter. The rate that it uses may be set in the "Rate" gadget.
  750.       The meter  runs continuously    whether visible or not. The default
  751.       rate is $4.75.
  752.  
  753.       SPECIAL KEYS / USER DEFINABLE KEYS:
  754.  
  755.       There are 10 special functions selectable from all possible  keys
  756.       and qualifiers.  They all  have default  values but  these may be
  757.       changed in the requester.  Clicking on the right half on the gad-
  758.       get  will  cycle up through the  functions,  clicking on the left
  759.       half will cycle down.
  760.  
  761.       Start/Stop     This  starts    or  stops  a  macro  definition  or
  762.              learning period. Type    the  key  combination, then
  763.              type  the  hotkey  that  you want this macro to be
  764.              bound to, then  type  your  macro.  When finished,
  765.              type the  key combination again.     This ends the
  766.              learning period. You may now execute  the macro by
  767.              typing the  hotkey. You  may also view or edit the
  768.              macro in the string gadget in the requester.
  769.              Default key = Alternate-ESCape.
  770.  
  771.       Execute     This executes the NewCli  command. You  may change
  772.              the executed command in the requester.
  773.              Default key = Left-Amiga-ESCape.
  774.  
  775.       Requester     This  executes  SetMach  just    like activating the
  776.              clock pressing the right button does.
  777.              Default key = Control-Left-Amiga-ESCape.
  778.  
  779.       Matcher     This is used  to  find  and  execute  a  macro. To
  780.              match, type  the key combination, then type enough
  781.              letters to  match  the  desired  macro,  then type
  782.              'return'. The rest of the macro will be executed.
  783.              Default key = Shift-Alternate-ESCape.
  784.  
  785.      *      W To Back     Send the front window to the back and activate the
  786.              top window.
  787.              Default key = Left-Amiga-K.
  788.  
  789.      *      W To Front     Send the back window to the front and activate the
  790.              top window.
  791.              Default key = Left-Amiga-J.
  792.  
  793.      *      Clock Top     Pop the clock to the top screen.
  794.              Default key = Left-Amiga-C.
  795.  
  796.      *      Next Confi     Make the next configuration in the list the active
  797.              one.
  798.              Default key = Control-Left-Amiga-C.
  799.  
  800.      *      Help         Display the help screen.
  801.              Default key = Alternate-HELP.
  802.  
  803.      *      Hot On/Off     Toggle  the  hot  keys  on  and  off.    Enables all
  804.              function keys    to be passed through even if macros
  805.              have been assigned to them.
  806.              Default key = Left-Amiga-H.
  807.  
  808.      *      Reset Prefs     This key combination is NOT user definable.  It is
  809.              Ctl-LShift-LAlternate-LAmiga-ESCape  and  it  will
  810.              set your  preferences to what the were when MachII
  811.              was first started.
  812.  
  813.      *      Note that selecting both  C= and  Amiga means  that you  must use
  814.       both the Left-Amiga (C=) key and the Right-Amiga key. The special
  815.       keys are entered in the "Key:"  gadget. You  may use  any key but
  816.       they    must  be  entered  correctly.  Usually    just  the first two
  817.       letters are needed for  these: TAB,  ESC, F1-F10,  DEL, BACKSPACE
  818.       RETURN,  HELP,  UP,  DOWN,  LEFT,  RIGHT,  and ENTER. All numeric
  819.       keypad keys must be prefaced with "K" and all other  keys by just
  820.       using what is on the keycaps.
  821.  
  822.       Example: "K"  is the letter "K" while "K9" is the keypad 9 key. A
  823.       "." is the period while "K."  is the  keypad period.  The 500 and
  824.       2000 have  5 keys  that the 1000 doesn't, the numeric keypad "(",
  825.       ")", "*", "+", "/" which all should be K(, K), K*, K+, K/.
  826.  
  827.  
  828.  
  829.       UNINSTALL:
  830.  
  831.       Use the Remove gadget to uninstall MachII or \Q in a macro.
  832.      *      Or run MachII a second time.
  833.  
  834.  
  835.       MISCELLANEOUS:
  836.  
  837.       When a string gadget (or  any  gadget  anywhere)  is  active, the
  838.       SunMouse will not work.
  839.  
  840.       When    WordPerfect  has  a  requester    up,  it  tries    to keep the
  841.       requester's window active. If MachII has the SunMouse  option on,
  842.       every mouse move will activate a window and then WP will activate
  843.       its requester's window. The only thing  to  do  is  turn  off the
  844.       SunMouse  or    hold  down  the  left  button. (I use a second con-
  845.       figuration (with a title of WordP)  with sunmouse  turned off and
  846.       the clock moved over off of the extra gadget.)
  847.  
  848.       This    program  will  NOT  work  from    Workbench.  Put  it in your
  849.       startup- sequence. In order to keep the current path, MachII does
  850.       not detach  from the    CLI. Use  RunBack or  ARun to allow the CLI
  851.       window to close. Also, run MachII after you have set your "path".
  852.  
  853.       MachII may fail to run for  any number  of reasons  (e.g. no free
  854.       signals, insufficient memory). You will be informed of this if it
  855.       is started with the Run command. If started  from RunBack (public
  856.       domain  program  that  will  allow  the  CLI    window to close and
  857.       available on Fred Fish disk # 65) and MachII fails, you won't get
  858.       any messages. The ARP command ARun may also be used.
  859.  
  860.       The NewCLI  brought up  by Amiga-ESC    will have  a stack the same
  861.       size as MachII. Many programs that you may run from this CLI need
  862.       a larger stack so either run MachII with a larger stack or, after
  863.       you get a NewCLI, use the stack command  to set  your stack  to a
  864.       larger value.  If programs  mysteriously crash  when run from the
  865.       NewCLI, it may be caused by the stack size.
  866.       Because MachII uses the Execute function, "Run" will not be found
  867.       if it has been made resident.
  868.  
  869.       If the macro size is set too small and you  try to  load a config
  870.       file with longer macros, the macro size gadget will be updated to
  871.       the largest macro . If you set the size too small and then select
  872.       "Done" then  activate the requester again, the macro size will be
  873.       set to the size needed for the largest macro.
  874.  
  875.       Let me  know if  you find  any incompatibilities  with other pro-
  876.       grams.
  877.  
  878.          Copyright 1988 by Brian Moats
  879.                    Polyglot Software
  880.                    10431 Ardyce Court
  881.                    Boise, Idaho 83704
  882.                    (208) 375-3741
  883.                    PeopleLink - BrianM
  884.                    CI$          - 76167,2334
  885.  
  886.  
  887.  
  888.  
  889.       Other  programs   for  the   Amiga  500/1000/2000  from  Polyglot
  890.       Software:
  891.  
  892.       M18Cheater     Lets you cheat in Mean 18 by causing your opponent
  893.              to slice. Public domain.
  894.  
  895.       -----------------------------------------------------------------
  896.  
  897.       FunBut     Lets you  use the F1 key instead of the left mouse
  898.              button.  It's  useful  when   playing  games  like
  899.              Defender  of  the  Crown  because  it sends repeat
  900.              mouse clicks.    Public Domain.
  901.  
  902.       -----------------------------------------------------------------
  903.  
  904.       4 IN ONE  Four easy to play games on one disk.
  905.  
  906.             SlotCars       For 1 or 2 players, arcade  type driving
  907.                    and shooting  game. Seven screens, great
  908.                    graphics.
  909.  
  910.             CircuitMania   For    1  or  2   players,  surround  your
  911.                    opponent in a maze of wires.
  912.  
  913.             ShufflePuzzle  Like the sliding number puzzles that you
  914.                    used to play  as  a    kid  but  this uses
  915.                    beautiful color pictures.
  916.  
  917.             Follow That Tune    Follow the bouncing boy as he jumps
  918.                     from pedestal  to  pedestal playing
  919.                     musical notes.
  920.  
  921.             These games are integrated into an easy to use package.
  922.             Enjoyable  for  all  ages.    All  use  digitized  sound.
  923.             $29.95
  924.  
  925.       -----------------------------------------------------------------
  926.  
  927.       Dominoes  3d graphics, speech,  tutorial.  More  entertaining and
  928.             challenging than Shanghai.    $24.95
  929.  
  930.       -----------------------------------------------------------------
  931.  
  932.       The Crossword Creator    Make or solve crossword puzzles. 40,000+
  933.                    word   pattern    matching    dictionary,
  934.                    med-res or interlace, IFF compatible and
  935.                    many more features. $49.95
  936.  
  937.  
  938.